home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / enscript.man < prev    next >
Encoding:
Text File  |  1989-04-01  |  8.2 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ENSCRIPT                  User Commands                  ENSCRIPT
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      enscript - convert text files to POSTSCRIPT format for
  10.      printing
  11.  
  12. SSYYNNOOPPSSIISS
  13.      eennssccrriipptt [ --1122BBGGgghhKKkkllmmooqqRRrr ] [ --LL_l_i_n_e_s ] [ --ff_f_o_n_t ] [
  14.      --FF_h_f_o_n_t ] [ --bb_h_e_a_d_e_r ] [ --pp_o_u_t ] [ _s_p_o_o_l_o_p_t_s ] [ _f_i_l_e_s ]
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      _e_n_s_c_r_i_p_t reads in plain text files, converts them to
  18.      POSTSCRIPT format, and spools them for printing on a
  19.      POSTSCRIPT printer.  Fonts, headings, limited formatting
  20.      options and spooling options may be specified.
  21.  
  22.      For example:
  23.           enscript -Paleph boring.txt
  24.      prints a copy of the file called boring.txt on the printer
  25.      called "aleph".
  26.           enscript -2r boring.c
  27.      prints a two-up landscape listing of the file called
  28.      boring.c on the default printer (see below).
  29.  
  30.      Font specifications have two parts: A font name as known to
  31.      POSTSCRIPT (e.g., Times-Roman, Times-BoldItalic Helvetica,
  32.      Courier), and a point size (1 point=1/72 inch - 8 point is a
  33.      good small font).  So Courier-Bold8 is 8 point Courier Bold,
  34.      Helvetica12 is 12 point Helvetica.
  35.  
  36.      The environment variable ENSCRIPT may be used to specify
  37.      defaults.  The value of ENSCRIPT is parsed as a string of
  38.      arguments _b_e_f_o_r_e the arguments that appear on the command
  39.      line.  For example "ENSCRIPT='-fTimes-Roman8'" sets your
  40.      default body font to 8 point Times Roman.
  41.  
  42.      The possible options are:
  43.  
  44.      --22   set in two columns.
  45.  
  46.      --11   set in one column (the default).
  47.  
  48.      --rr   rotate the output 90 degrees (landscape mode).  This is
  49.           good for output that requires a wide page or for pro-
  50.           gram listings when used in conjunction with -2.
  51.           "enscript -2r files" is a nice way to get program list-
  52.           ings.
  53.  
  54.      --RR   don't rotate, also known as portrait mode (the
  55.           default).
  56.  
  57.      --GG   print in gaudy mode: causes page headings, dates, page
  58.           numbers to be printed in a flashy style, at some slight
  59.           performance expense.
  60.  
  61.  
  62.  
  63. Adobe Systems              12 Nov 1985                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ENSCRIPT                  User Commands                  ENSCRIPT
  71.  
  72.  
  73.  
  74.      --ll   simulate a line printer: make pages 66 lines long and
  75.           omit headers.
  76.  
  77.      --BB   omit page headings.
  78.  
  79.      --bb_h_e_a_d_e_r
  80.           sets the string to be used for page headings to _h_e_a_d_e_r.
  81.           The default header is constructed from the file name,
  82.           its last modification date, and a page number.
  83.  
  84.      --LL_l_i_n_e_s
  85.           set the maximum number of lines to output on a page.
  86.           _E_n_s_c_r_i_p_t usually computes how many to put on a page
  87.           based on point size, and may put fewer per page than
  88.           requested by _l_i_n_e_s.
  89.  
  90.      --ff_f_o_n_t
  91.           sets the font to be used for the body of each page.
  92.           Defaults to Courier10, unless two column rotated mode
  93.           is used, in which case it defaults to Courier7.
  94.  
  95.      --FF_h_f_o_n_t
  96.           sets the font to be used for page headings.  Defaults
  97.           to Courier-Bold10.
  98.  
  99.      --pp_o_u_t
  100.           causes the POSTSCRIPT file to be written to the named
  101.           file rather than being spooled for printing.  As a spe-
  102.           cial case, --pp -- will send the POSTSCRIPT to the stan-
  103.           dard output.
  104.  
  105.      --gg   causes the fact that a file is garbage to be ignored.
  106.           Normally, any file with more than a small number of
  107.           non-printing characters is suspected of being garbage,
  108.           and not printed - this option means "print it anyway."
  109.  
  110.      --oo   If _e_n_s_c_r_i_p_t cannot find characters in a font, the miss-
  111.           ing characters are listed.
  112.  
  113.      --qq   causes _e_n_s_c_r_i_p_t to be quiet about what it is doing.
  114.           _E_n_s_c_r_i_p_t won't report about pages, destination, omitted
  115.           characters, etc. Fatal errors are still reported to the
  116.           standard error output.
  117.  
  118.      --kk   enables page prefeed (if the printer supports it).
  119.           This allows simple documents (e.g., program listings in
  120.           one font) to print somewhat faster by keeping the
  121.           printer running between pages.
  122.  
  123.      --KK   disable page prefeed (the default).
  124.  
  125.      --hh   suppress printing of job burst page.
  126.  
  127.  
  128.  
  129. Adobe Systems              12 Nov 1985                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ENSCRIPT                  User Commands                  ENSCRIPT
  137.  
  138.  
  139.  
  140.      In 4.2bsd systems, the following spooler options are also
  141.      recognized:
  142.  
  143.      --PP_p_r_i_n_t_e_r
  144.           causes the output to be sent to the named printer.
  145.  
  146.      --##_n  causes _n copies of the output to be produced.  The
  147.           default is one.
  148.  
  149.      --mm   causes the printer daemon to send mail upon job comple-
  150.           tion.
  151.  
  152.      --JJ_n_a_m_e
  153.           sets the job name for use on the burst page.  Other-
  154.           wise, the name of the first input file will be used.
  155.  
  156.      --CC_c_l_a_s_s
  157.           set the job classification for use on the burst page.
  158.  
  159.      In System V, the following spooler options are also recog-
  160.      nized:
  161.  
  162.      --tt_t_i_t_l_e
  163.           sets job title for use on the burst page.
  164.  
  165.      --dd_d_e_s_t
  166.           causes the output to be sent to the named printer or
  167.           printer class.
  168.  
  169.      --nn_n  causes _n copies of the output to be produced. The
  170.           default is one.
  171.  
  172.      --ww or --mm
  173.           causes the printer daemon to write or send mail upon
  174.           job completion.
  175.  
  176. EENNVVIIRROONNMMEENNTT
  177.      ENSCRIPT
  178.           string of options to be used by _e_n_s_c_r_i_p_t.
  179.  
  180.      PSLIBDIR
  181.           path name of a directory to use instead of
  182.           /usr/local/lib/ps for enscript prologue and font metric
  183.           files.
  184.  
  185.      PSTEMPDIR
  186.           path name of temporary directory to use instead of
  187.           XPSTEMDIRX of spooled temporary files.
  188.  
  189.      PRINTER (4.2bsd)
  190.           the name of a printer (as in the --PP option) for _l_p_r to
  191.           use.  If no --PP option is specified, _l_p_r will use this
  192.  
  193.  
  194.  
  195. Adobe Systems              12 Nov 1985                          3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ENSCRIPT                  User Commands                  ENSCRIPT
  203.  
  204.  
  205.  
  206.           printer.  If neither --PP nor PRINTER is set, _e_n_s_c_r_i_p_t
  207.           will spool to a printer named ``PostScript''.
  208.  
  209.      LPDEST (System V)
  210.           the name of a printer (as in the --dd option) for _l_p to
  211.           use.  If no --dd option is specified, _l_p will use this
  212.           printer.  If neither --dd nor LPDEST is set, _e_n_s_c_r_i_p_t
  213.           will spool to a printer class named ``PostScript''.
  214.  
  215. FFIILLEESS
  216.      /usr/local/lib/ps/*.afm
  217.                            font metrics files.
  218.  
  219.      /usr/local/lib/ps/enscript.pro
  220.                            prologue for enscript files.
  221.  
  222.      lpr(1 bsd), lp(1 V)   Printer spooler
  223.  
  224. SSEEEE AALLSSOO
  225.      pr(1), ps630(1), getopt(3).
  226.      4.2bsd: lpr(1), lpq(1), lprm(1).
  227.      System V: lp(1), cancel(1), lpstat(1).
  228.  
  229. DDIIAAGGNNOOSSTTIICCSS
  230.      Should be self explanatory.
  231.  
  232. AAUUTTHHOORR
  233.      Adobe Systems Incorporated
  234.      Gaudy mode by Guy Riddle of AT&T Bell Laboratories
  235.  
  236. FFEEAATTUURREESS
  237.      Options and the ENSCRIPT environment string are parsed in
  238.      _g_e_t_o_p_t(3) fashion.
  239.  
  240. BBUUGGSS
  241.      Long lines are truncated.  Line truncation may be off by a
  242.      little bit as printer margins vary.  There should be a
  243.      "wrap" option and multiple (truncated or wrapped) columns.
  244.  
  245.      _E_n_s_c_r_i_p_t generates temporary files which are spooled for
  246.      printing.  The temporary file names are used by the spooling
  247.      software (e.g., _l_p_q), rather than the symbolic job name
  248.      passed to _l_p_r.
  249.  
  250.      There are too many options.
  251.  
  252. NNOOTTEESS
  253.      POSTSCRIPT is a trademark of Adobe Systems Incorporated.
  254.      Times and Helvetica are registered trademarks of Allied Cor-
  255.      poration.
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Adobe Systems              12 Nov 1985                          4
  262.  
  263.  
  264.  
  265.